standardalert.htmlHTMLudogEsπùΔ§πùΔ§ÅÅVM Monkeybread Realbasic plugin - Documentation - StandardAlert

MBS Plugin Documentation

This is the documentation for the Realbasic Plugins from Monkeybreadsoftware.de. You find these plugins and the newest version of this document at http://www.monkeybreadsoftware.de/realbasic inside the plugins section.

This help was last updated on Freitag, 6. September 2002 and covers 2136 items: 126 classes, 2 controls and 583 global functions.

The list of the themes Global methods by category Global methods by name The list of the classes The list of the controls

class StandardAlert
class, StandardAlert Mi, 1. Mai 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: This class offers you customized standard alert dialogs.
Notes:
You may create your own module around to give yourself some nice functions like this:

Sub ErrorAlert(error as string,explanation as string)
dim s as standardAlert

s=new standardAlert
s.Type=2
s.Error=error
s.explanation=explanation
s.UseDefaultDefaultButtonCaption=true
s.whichisCancelButton=0
s.whichisDefaultButton=1
s.Moveable=true
s.position=0
s.run

msgBox str(s.resultError)
End Sub

CancelButtonCaption as String
property, StandardAlert Mi, 1. Mai 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Does nothing.
Function: The button caption to use for the cancel button.

CancelButtonCaption as String
property, StandardAlert Sa, 27. Jul 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Does nothing.
Function: whether to use the default caption for the cancel button.

DefaultButtonCaption as String
property, StandardAlert Sa, 27. Jul 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Does nothing.
Function: whether to use the default caption for the default button.

DefaultButtonCaption as String
property, StandardAlert Mi, 1. Mai 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Does nothing.
Function: The button caption to use for the default button.

Error as string
property, StandardAlert Mi, 1. Mai 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: The error message.
Notes: Limited to 255 characters.

Explanation as string
property, StandardAlert Mi, 1. Mai 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: The explantation to the error message.
Notes: Limited to 255 characters.

HelpButton as boolean
property, StandardAlert Sa, 27. Jul 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: whether the dialog should have an help button.

Moveable as boolean
property, StandardAlert Sa, 27. Jul 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: whether the dialog should be moveable.

OtherButtonCaption as String
property, StandardAlert Mi, 1. Mai 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Does nothing.
Function: The button caption to use for the third button.
Example:
If OtherButtonCaption="" and not UseDefaultOtherButtonCaption then
' no third button will be showed
end if

Position as integer
property, StandardAlert So, 26. Mai 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Does nothing.
Function: Which position the dialog should have.
Notes:
Possible values:

0Defaultposition
1Center on main screen
2Main screen
3Stagger on main screen
4Center on parent window
5Parent Window
6Stagger on parent window
7Center on parent screen
8Parent screen
9Stagger on parent screen

ResultError as integer
property, StandardAlert Mi, 1. Mai 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Does nothing.
Function: The error code of the Run method.
Notes:
StandardAlert was introduced with Mac OS 8.1 so it may be not available. In this case the ResultError property has the value -1.

You get Error -50 if the properties of the object are out of range.

Run
method, StandardAlert Mi, 1. Mai 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: Shows the alert dialog.

Type as integer
property, StandardAlert So, 26. Mai 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: Which type of alert.
Notes:
Possible values:

0Stop
1Note
2Caution
3Plain

UseDefaultOtherButtonCaption as String
property, StandardAlert Sa, 27. Jul 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Does nothing.
Function: whether to use the default caption for the button.
Notes: Should show "Don't save".

WhichisCancelButton as integer
property, StandardAlert So, 26. Mai 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Does nothing.
Function: Which button should be the cancel button.
Notes:
Possible values on Mac:

0Default
1OK Button
2Cancel Button
3Other Button
4Help Button

WhichisDefaultButton as integer
property, StandardAlert So, 26. Mai 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: Which button should be the default button.
Notes:
Possible values on Mac:

0Default
1OK Button
2Cancel Button
3Other Button
4Help Button

On Windows it's the number of the default button.

WindowsButtons as integer
property, StandardAlert Mi, 29. Mai 2002
Mac OS Classic: Does nothing. Mac OS Carbon: Does nothing. Windows: Works.
Function: Which buttons to show on Windows.
Notes:
Possible values:
0OK
1OK Cancel
2Retry Cancel
3Yes No
4Yes No Cancel
5Abort Retry Ignore

Contact

Written 2002 by Christian Schmitz. Feel free to ask or report mistakes to realbasic@macsw.de.
Thanks.

This resource fork intentionally left blank ˇˇ